home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_200 / 295_01 / bflush.c < prev    next >
Text File  |  1989-12-28  |  2KB  |  85 lines
  1. /*    Copyright (c) 1989 Citadel    */
  2. /*       All Rights Reserved        */
  3.  
  4. /* #ident    "bflush.c    1.2 - 89/10/31" */
  5.  
  6. #include <errno.h>
  7. #include "blkio_.h"
  8.  
  9. /*man---------------------------------------------------------------------------
  10. NAME
  11.      bflush - flush a block file
  12.  
  13. SYNOPSIS
  14.      #include <blkio.h>
  15.  
  16.      int bflush(bp)
  17.      BLKFILE *bp;
  18.  
  19. DESCRIPTION
  20.      The bflush function causes any buffered data for the block file
  21.      associated with BLKFILE pointer bp to be written to the file and
  22.      the buffers to be emptied.  The header, if it has been modified,
  23.      is written out last.  The block file remains open.  If  bp is
  24.      open read-only or is not buffered, there will be no data to flush
  25.      and bflush will return a value of zero immediately.
  26.  
  27.      bflush should be called immediately before a block file is
  28.      unlocked.  lockb does this automatically.
  29.  
  30.      bflush will fail if one or more of the following is true:
  31.  
  32.      [EINVAL]       bp is not a valid BLKFILE pointer.
  33.      [BENOPEN]      bp is not open.
  34.  
  35. SEE ALSO
  36.      bexit, bputb, bsync.
  37.  
  38. DIAGNOSTICS
  39.      Upon successful completion, a value of 0 is returned.  Otherwise,
  40.      a value of -1 is returned, and errno set to indicate the error.
  41.  
  42. ------------------------------------------------------------------------------*/
  43. int bflush(bp)
  44. BLKFILE *bp;
  45. {
  46.     /* validate arguments */
  47.     if (!b_valid(bp)) {
  48.         errno = EINVAL;
  49.         return -1;
  50.     }
  51.  
  52.     /* check if not open */
  53.     if (!(bp->flags & BIOOPEN)) {
  54.         errno = BENOPEN;
  55.         return -1;
  56.     }
  57.  
  58.     /* check if not open for writing */
  59.     if (!(bp->flags & BIOWRITE)) {
  60.         errno = 0;
  61.         return 0;
  62.     }
  63.  
  64.     /* check if not buffered */
  65.     if (bp->bufcnt == 0) {
  66.         errno = 0;
  67.         return 0;
  68.     }
  69.  
  70.     /* synchronize file with buffers */
  71.     if (bsync(bp) == -1) {
  72.         BEPRINT;
  73.         return -1;
  74.     }
  75.  
  76.     /* empty the buffers */
  77.     if (b_initlist(bp) == -1) {
  78.         BEPRINT;
  79.         return -1;
  80.     }
  81.  
  82.     errno = 0;
  83.     return 0;
  84. }
  85.